home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / net / bind-contrib.tar.gz / bind-contrib.tar / contrib / misc / ddt.info < prev    next >
Encoding:
Internet Message Format  |  1996-10-25  |  6.9 KB
  1. Date: Mon, 26 Apr 93 17:45:39 GMT
  2. From: Jorge Frazao de Oliveira <frazao@colombo.puug.pt>
  3. Message-Id: <9304261745.AA02646@colombo.puug.pt>
  4. Received: by NeXT Mailer (1.62)
  5. To: vixie
  6. Subject: Re: send me your tools
  7.  
  8. Hi,
  9.  
  10.   I have implemented a package that allow to check several of the
  11.  most usually problems in DNS.
  12.   Find attached the introduction page of the manual.
  13.  
  14.   This package is available in ftp.ripe.net:/tools/dns/ddt.
  15.  
  16.   I'll appreciate your comments,
  17.   Thanks
  18.  
  19.   Jorge Frazao
  20.  
  21. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  22.    May 6 1992                                                          ddt(1)
  23.                                                     Domain Debug Tools Manual
  24.  
  25.  
  26.  
  27.    NAME
  28.      ddt - domain debug tools
  29.  
  30.    DESCRIPTION
  31.      The DNS database is a distributed database where almost all the distri-
  32.      buted bindings of the TCP/IP application level take place. This database
  33.      is managed by several primary and secondary servers running in a
  34.      master/slave fashion.  During updates, there are temporary inconsisten-
  35.      cies that are more or less tolerated by the different user services.  By
  36.      its nature, the database is managed in a descentralized way, with hun-
  37.      dreds, or even thousands, of individuals envolved. This is a very
  38.      interesting and valuable feature of this application.  However, in con-
  39.      junction with the fact that inconsistencies must be tolerated, this col-
  40.      lective managing style may lead to the introduction of hard to find
  41.      errors.  Sometimes, some of these errors can introduce several problems
  42.      and resource usage far from ideal.
  43.  
  44.      Ddt (domain debug tools) is a package to help zone administrators to
  45.      avoid as much as possible these problems.  The package is a set of com-
  46.      mands that allow administrators to analyze any portion of the DNS tree.
  47.  
  48.      Ddt works on cached data files because, as such, it can be reasonable
  49.      efficient.  A command is available to try to cache the "real world"
  50.      situation as close as possible.  This command, ddt-xfer(1), is a
  51.      slightly modified version of the bind named-xfer(8) that allows the
  52.      transfer to the cache of a zone and, optionally, all its descendents
  53.      zones. If you have enough disk and bandwith, you can cache all the zones
  54.      of the world with one only command.  Probably, at end, you should start
  55.      again because some of the cached zones will not reflect the real ones
  56.      anymore.
  57.  
  58.      All the available commands can receive one or more zone files as parame-
  59.      ters.  So, one command can spread its analysis throughout a set of
  60.      zones.  With the exception of ddt-xfer(1), all commands are written in
  61.      gawk (GNU awk).
  62.  
  63.      The commands available are:
  64.  
  65.        ddt-xfer  to cache one or more zones.
  66.  
  67.        soac      to analyze the RRs that describe the top node of the zone,
  68.                  i.e., the NS RRs that list the servers for the zone and a
  69.                  single SOA RR that describe zone management parameters.
  70.  
  71.        rrc       to check the semantic of the RRs, like valid host names,
  72.                  names without trailing dot, etc.
  73.  
  74.        grc       to analyze the glue records for a zone.
  75.  
  76.        mxc       to analyze the MX RRs defined within a zone.
  77.  
  78.        rmc       to analyze the reverse mapping.
  79.  
  80.  
  81.                                                                             1
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.    ddt(1)                                                          May 6 1992
  89.    Domain Debug Tools Manual
  90.  
  91.  
  92.  
  93.  
  94.      Besides the commands that allow the analysis of the zone, there are some
  95.      small commands to obtain several accounts, like number of hosts, number
  96.      of nets, number of domains, most popular names, etc.  In conjunction
  97.      with some user written awk scripts, it is easy to obtain a lot of other
  98.      information.  These commands are the following filters:
  99.  
  100.        expand       replaces the owner name of the RR by an absolute or fully
  101.                     qualified name.
  102.  
  103.        hosts        returns all hosts in the zone.
  104.  
  105.        hosts-addr   returns all hosts with their ip-addresses.
  106.  
  107.        hosts-domain returns all domains defined in the zones with the number
  108.                     of hosts per domain.
  109.  
  110.        cnames       returns all nicknames in the zone.
  111.  
  112.        nets         returns all nets in the zone with the number of hosts per
  113.                     network.
  114.  
  115.        names-stat   does some statistics about names.
  116.  
  117.  
  118.      To make the interpretation of the several messages returned by the
  119.      available commands easier, those messages are divided into four levels
  120.      of severity:
  121.  
  122.        [Warning 1] You should investigate it now!
  123.  
  124.        [Warning 2] Don't forget this warning!
  125.  
  126.        [Warning 3] You should analyze it someday!
  127.  
  128.        [Comment] You can ignore it /
  129.                  DDT has not enough data to take an effective decision.
  130.  
  131.      Messages belonging to [Warning 1] level are the most serious. On the
  132.      other hand, messages belonging to [Comment] level are less important,
  133.      but this doesn't mean that these messages can be completely ignored.
  134.      Unfortunately,  there are some serious errors that were included in the
  135.      this level because, when the message is displayed, DDT has not enough
  136.      data (zone files) to take an effective decision.
  137.  
  138.      The DDT_LEVEL environment variable is used to select what messages
  139.      should be displayed. If it has the value 1, only messages belonging to
  140.      [Warning 1] level are displayed. If it is 2 are displayed all messages
  141.      belonging to [Warning 1] and [Warning 2] levels and so on.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.    2
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.    May 6 1992                                                          ddt(1)
  155.                                                     Domain Debug Tools Manual
  156.  
  157.  
  158.      The commands ddt-xfer(1), grc(1), mxc(1), rrc(1) rmc(1) and saoc (1) are
  159.      described in separate manual pages. The commands for gathering statis-
  160.      tics about zones are described below with some examples.
  161.  
  162.      1) Get all zones below the domain fr. (inclusive):
  163.  
  164.        ddt-xfer -z fr -f . -r inria.inria.fr layon.inria.fr
  165.  
  166.  
  167.      2) Get the zone ul.pt only if the serial number had changed:
  168.  
  169.        ddt-xfer -z ul.pt -f . -s 199202140 muttley.ul.pt dec4pt.puug.pt
  170.  
  171.  
  172.      3) Generate the portuguese statistics of hostnames (All zones below pt.
  173.         are in /usr/local/ddt.cache/pt directory):
  174.  
  175.        expand /usr/local/ddt.cache/pt/* | hosts | names-stat | sort -rn
  176.  
  177.  
  178.      4) Count hosts in a zone beginning at the node inesc.pt (The zone
  179.         inesc.pt is in the file /usr/local/ddt.cache/pt/inesc.pt):
  180.  
  181.        expand /usr/local/ddt.cache/pt/inesc.pt | hosts | wc -l
  182.  
  183.  
  184.      5) Print the number of hosts by nets in Italy (All zones below it. are
  185.         in /usr/local/ddt.cache/it directory):
  186.  
  187.        expand /usr/local/ddt.cache/it/* | hosts-addr | nets | sort -rn
  188.  
  189.  
  190.      Comments and suggestions are welcome.
  191.  
  192.    SEE ALSO
  193.      ddt-xfer(1), soac(1), rrc(1), mxc(1), grc(1), rmc(1)
  194.  
  195.    AUTHOR
  196.      Jorge Frazao
  197.  
  198.